Introduction  to  BASCOM  AVR  Compiler 

Written  by  Cholis  Safrudin  (YD1CHS),  mid  of  April  2011 
#1  -  kumpulan  materi  belajar  bareng  AVR 


BASCOM  AVR? 

Tulisan  berikut  ditulis  bukan  sebagai  text  book,  karena  isinya  dituangkan  berdasarkan  pengalaman 
penulis  selama  belajar  otodidak  tentang  mikrokontroler.  Hanya  cocok  untuk  diaplikasikan  untuk 
keperluan  non  profesional,  eksperimen,  dan  hobby. 

Banyak  sekali  kompiler  berbahasa  level  tinggi  (C,  BASIC,  PASCAL,  dll)  yang  bertebaran  di  Internet  dan 
sebagian  ditawarkan  secara  gratis.  Salah  satunya  adalah  kompiler  menggunakan  bahasa  BASIC  untuk 
mikrokontroler  produk  AVR,  yaitu  BASCOM.  Hingga  saat  tulisan  ini  ditulis,  MCS  Electronics 
pemroduksi  BASCOM  hanya  dikembangkan  untuk  mikrokontroler  produk  ATMEL,  yaitu  8051  dan 
AVR.  Namun  disini  akan  dibahas  AVR  saja.  MSC  memberikan  kesempatan  kepada  kita  untuk 
mendownload  versi  demo  dengan  keterbatasan  besarnya  file  code  hanya  sampai  dengan  4KB  saja, 
dan  bagi  yang  berminat  silakan  mengikuti  link  berikut: 

http://www.mcselec.com/index.php?option=com  docman&task=cat  view&gid=99&ltemid=54 

Mungkin  ada  yang  bertanya  4KB  code  itu  besar  atau  kecil.  Saya  ambil  contoh  saja  AVR  ATMEGA-8 
memiliki  program  memory  (memori  tempat  menyimpan  kode  program)  sebesar  8KB,  artinya  adalah 
50%  dari  total  kapasitanya,  menurut  saya  ...  untuk  keperluan  belajar  dan  hobby  sudah  sangat  besar. 
Mari  kita  ambil  contoh: 

•  Sebuah  HF  Frequency  Counter  dengan  tampilan  LCD,  dilengkapi  dengan  fitur  Autoranging 
Display,  IF  Shifted  Display  dan  manipulasi  EEPROM  yang  telah  saya  buat  hanya  membutuhkan 
40%  dari  total  program  memory  ATMEGA-8  atau  hanya  3.2KB. 

•  Sebuah  FLL  (Frequency  Locked  Loop),  yang  didalamnya  berisi  Frequency  Counter,  Autoranging 
Display,  IF  Shifted  display,  EEPROM  Manipulation  dan  Locking  Mechanism  dengan  PWM  hanya 
membutuhkan  48%  dari  total  program  memory  ATMEGA-8  atau  hanya  3.84KB. 

Mudah-mudahan  ketiga  contoh  projects  diatas  bisa  memberikan  gambaran  bahwa  4KB  di  dalam 
pemrograman  mikrokontroler  adalah  sangat-sangat  berarti. 

MENGGUNAKAN  BASCOM 

Seperti  yang  telah  saya  sebutkan  di  atas,  bahwa  apa  yang  saya  sampaikan  disini  bisa  jadi  bukanlah 
prosedur  paling  tepat  sesuai  rekomendasi  BASCOM,  namun  hanya  praktik  yang  biasa  saya  lakukan. 
Jadi  hanya  cocok  untuk  eksperimen  saja  dan  segala  resiko  ...  mohon  maaf,  silakan  ditanggung  sendiri. 
Hehehe. 

Saya  tidak  mau  bertele-tele  untuk  menjelaskan  berbagai  hal  yang  sudah  mulai  menyentuh  teori  atau 
hal-hal  terkait  text  book,  karena  tidak  cocok  dengan  metode  belajar  kita,  yang  menuntuk  instan 
serta  konsentrasi  hal-hal  yang  biasa  kita  perlukan  saja  untuk  membangun  project-project  hobby. 

SETTING  ENVIRONTMENT  BASCOM 

Saya  hanya  asal  comot  saja  penyebutan  prosedur  ini,  silakan  anda  namakan  apa  saja  yang  jelas 
prosedur  ini  memastikan  bahwa  environtment  dari  kompiler  BASCOM  sesuai  dengan  mikrokontroler 
yang  sedang  kita  buat  firmware-nya.  Setting  ini  hanya  melekat  kepada  satu  file  firmware  saja,  jadi 
setiap  membuat  file  firmware  harus  dilakukan  prosedur  ini.  Berikut  langkah  utamanya. 
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Ilustrasi  Grafis 


llustrasi  Deskriptif 


Options    Window  Help 
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1.  Langkah  pertama,  buka  aplikasi 
BASCOM. 

2.  Buat  file  firmware  yang  baru,  beri 
nama  sesuai  dengan  keinginan 
anda  (baca  prosedur  pembuatan 
firmware  di  bawah). 


BASCOM-AVR  Options 


Compiler  |  Communication  |  Environment  |  Simulator  |  Programmer  |  Monitor  |  Printer  j 
Chip    |  Output  |  Communication!  I2C,  SPI,  1WIRE  |  LCD    |  Options  | 


Chip 

m8def.dat 

FlashROM 

|8  KB 

m8515.dat 

XRAM 

m8535.dat 
m88def.dat 

SRAM 

|1 024 

HW  Stack 

m88pdef.dat 

mSdef.dat              ,  ■ 

EEPROM 

|512 

Soft  Stack 

ushUe7.dat 
usbl  S2.dat 
usb646.dat 

H  1 

I-  XRAM  waitstate 

Framesize 

24 

|~  External  Access  Enable 

Default 


3.  Pada  Menu  Bar  (Atas),  click  Option 
»  Compiler »  Chip 

4.  Pada  dialog  box  Option,  pada 
menu  bar  click  Chip  »  Chip:  sesuai 
dengan  mikrokontroler  yang 
sedang  dikerjakan,  contoh  disini 
adalah  ATMEGA-8,  maka  pilih 
m8def.dat 

5.  Simpan  file  tersebut 


Sebenarnya  kenapa  kita  harus  melakukan  setting  dasar  ini? 

Karena  seluruh  command  atau  library  yang  terkait  dengan  mikrokontroler  tersebut  disimpan  pada 
file  m8def.dat  (untuk  ATMEGA-8).  Isi  file  ini  diantaranya  adalah  deklarasi  variable-variable  default 
dari  mikrokontroler. 


Prosedur  ini  sebenarnya  perlu  kita  lakukan  untuk  memaksa  kompiler  untuk  melakukan  aktivitasnya 
bagi  mikrokontroler  tertentu.  Prosedur  serupa,  namun  metodenya  lain  bisa  kita  lakukan  dengan 
melakukannya  di  dalam  firmware.  Biasanya  kita  tuliskan/  lakukan  pada  baris  teratas  firmware  kita, 
dengan  contoh  syntax: 

$regfile  =  "m8def.dat"  untuk  memaksa  environtment  compiler  ATMEGA-8 

$crystal  =  8000000  memberitahu  compiler  bahwa  Xtal  yang  dipakai  adalah  8MHz 

Nah,  kebiasaan  saya  adalah  melakukan  kedua-duanya.  Silakan  anda  yang  memilih  sesuai  kesukaan 
anda. 
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MEMBUAT  FIRMWARE  BARU 


llustrasi  Grafis 


llustrasi  Deskriptif 
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r 


J  New 

t>  OperK" 
Close 


Ctrl+N 


Ctrl+O 


1.  Buka  BASCOM 

2.  Pada  Menu  Bar  (Atas),  click 
File  »  New 


Save  in:  |  _J  Bdaiar_AVR 

BelajarJWR.bas 


1  jii  e?  m> 


File  name: 
Save  as  type: 


|l:FPP»A'i:l!H 

zi 

Save  j 

|BASCOM-AVR  Hes("BAS) 

zi 

Cancel  | 

3.  Pada  dialog  box  Save  As, 
beri  nama  file  firmware, 
saya  anjurkan  untuk 
menyimpan  1  project/ 
firmware  dalam  1  direktori 
berbeda,  karena  setelah 
dikompile  nanti  akan 
muncul  file-file  tambahan 
lainnya,  sehingga  lebih 
mudah 

mengorganisasikannya 

4.  Click  Save 


Options    Window  Help 


Compiler 


Communication 
Environment 
Simulator 
Programmer 
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Printer 


Chi 


Output 
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I2C 

LCD 

Misc 


5.  Pada  Menu  Bar  (Atas),  click 
Option  »  Compiler  »  Chip 
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Ilustrasi  Grafis 


llustrasi  Deskriptif 


BASCOM  AVR  Options 


Compiler  |  Communication  |  Environment  |  Simulator  |  Programmer  j  Monitor  |  Printer  | 
Chip    |  Output  |  Communication  |  I2C,  SPI,  1WIRE  j  LCD    |  Options  | 


Default 


□  k 


Chip 

rn8def.dat 

T 

FlashROM 

|8  KB 

XFIAM 

rn8515.dat 
m8535.dat 
m88def.dat 

A 

SRAM 

|1024 

HW  Stack 

m88pdef.dat 

EEPROM 

|512 

usbl  2S7.dat 

Soft  Stack 

usbl  GZdat 
usbG4G.dat 

I-  XRAM  waitstate 

Framesize 

24 

I-  External  Access  Enable 

X  Cancel 


6.  Pada  dialog  box  Option, 
pada  menu  bar  click  Chip 
»  Chip: sesuai  dengan 
mikrokontroler  yang 
sedang  dikerjakan,  contoh 
disini  adalah  ATMEGA-8, 
maka  pilih  m8def.dat 

7.  Simpan  kembali  file 
tersebut 

8.  Sekarang  file  firmware  dan 
environment  BASCOM 
telah  sesuai  dengan 
ATMEGA-8 


MENULIS  FIRMWARE 

Gaya  cara  menulis  sebuah  program  atau  firmware  sangat  bervariasi  dan  unik  untuk  masing-masing 
individu,  namun  sekali  lagi  saya  akan  sampaikan  disini  kebiasaan  saya  menuliskan,  silakan  memilih 
sendiri  gaya  penulisan  yang  sesuai. 


1  1. 

Judul  Project,   deskripsi  dan  sebagainya 

'  2. 

Environtment  untuk  kompiler   {compiler  directives) 

'  3. 

Setup-setup  PORT  10,  dll 

'  4. 

Deklarasi  Variables 

1  5. 

Program  Loop  Utama 

'  6. 

Kumpulan  Function/  Subroutine 

Berikut  contoh  gaya  penulisan  project  Digital  Voltmeter  using  AVR  yang  telah  saya  buat  untuk 
ATMEGA-16  dengan  external  Crystal  sebesar  8MHz,  sekali  lagi  gaya  penulisan  tergantung  dengan 
masing-masing  orang,  silakan  menyesuaikan. 


1.   Project  title  and  Description 
Project:   Digital  Voltmeter 
Designed  by  Cholis   Safrudin  YD1CHS 


Using  ADC  to  sense  the  voltage  variation  from  the  divider  circuit 
Displaying  into  LCD 
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' 2 .    Compiler  Directives 

$recffile  —  "ml  6def  .  dat " 

' At mega- 1 6 

^crystal  —  oUUUUUU 

Atal  oMriZ 

'  3 .    Setup  Port   10  dan  Hardware 

Conf ig  Lcdpin  =  Pin  ,    Db4  =  Porte 

A                    Ca     —     D  ^a  v-4-  Ca 

.4  ,   udo  —  rorrc.o  ,   

Db6  =  Porte. 6   ,    Db7  =  Porte. 7   ,  E 

=  Porte. 2   ,    Rs  =  Porte. 0 

'4  bits  mode,  Port-C 

Lonng  LiCCi  —  lb   *  z 

lox^  L.naract.ers  1jL.jj 

Cls 

'Clear  Screen 

Cursor  Off 

'Cursor  is  Off 

wait  ror  ouums 

Config  Adc  =  Single   ,    Prescaler  = 

Auto 

'ADC  Configuration 

Start  Adc 

'Start  ADC,    not  necessary  since 
'it  started  automatically 

'4.  Variable  Declaration 
i 

Dim  Bat_pow  As  Word 

'Variable  to  Store  Battery  Power 

65535 

'Word   =    6    Bytes,    value    from    0  to 

Dim  Bat_fact   As  Single 
Factor 

'Variable  to  Store  Correction 

x  10A-45  to  3.4  x  10"38 

'Single   =   3   Bytes,    value   from  1.5 

Dim  Bat_volt  As  Single 

'Variable  to  Store  Battery  Voltage 

X    1U       4  J    to    o  .  4    X    1U  oo 

'Single  =   3   Bytes,    value   from  1.5 

bat  tact  —  iz  /  5Uo 

' Set  Battery  Scale 

'5.   Print  Welcome  Messages  &  Wait 

until  VCO  is   Steady  state 

Led  "AVRLCD  Voltmeter" 

'Print  1st  Message 

Waitms  100 

'  wait 

Lowe  r 1 ine 

' go  to  line  2 

Leo      Dy    LnOllS  iDlLrib 

'Print  2nd  Message 

waitms  zuuu 

'wait   for  2000ms 

Cls 

'Clear  Screen 

'6.   Main  Program  Loop  -  Battery's 

Power  Testing  dan  Display 

Into  LCD 

'   Battery  is   12V,    using  external 

resistors  as   scaler  18K//4 

7K 

'   Battery  is   12V,   Vmax  =    (4.7K  // 

18K) *12  =  2 .484581 

'   5V  input  is  indicates  by  1024, 

so  that  2.484581  is  indicates  by  508 

'   So  that,    1  =  12/508  =  This  is  a 

correction  factor 
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Do 

Bat_pow  =  Getadc(O) 

'Get  Batt  Power  at  ADC0 

Bat_volt  =  Bat_pow  *  Bat_fact 

'Get  a  riil  voltage  value 

If  Bat_pow  <  430  Then 

'Battery  is   low,    warn  to  user 

Led  "Batt.   Power:  BAD" 

'Print   "Batt.   Power:  BAD" 

Lowerline 

'go  to  line  2 

Led  Fusing (bat_volt  ,    "##.##")    ;    "  Volts" 

'Print  Battery  Voltage  Value 

Waitms  1000 

'  wait 

Else 

'Battery  is  Good 

Led  "Batt.   Power:  OK" 

'Print   "Batt.   Power:  OK" 

Lowerline 

'go  to  line  2 

Led  Fusing (bat_volt   ,    "##.##")    ;    "  Volts" 

'Print  Battery  Voltage  Value 

Waitms  1000 

'  wait 

End  If 

Cls 

'Clear  Screen 

Loop 

'Repeated  again 

End 

' end  program 

MENGKOMPILE  FIRMWARE 

Saya  yakin  semua  telah  mengetahui  proses  apa  ini, 
firmware  dari  bahasa  tingkat  tinggi,  melingkingkan 
bahasa  mesin,  sehingga  siap  untuk  didownload 

paling  gampangnya  ngomong  adalah  mengubah 
dengan  berbagai  hal,  kemudian  merubahnya  ke 
ke  uP.  Berikut  ilustrasi  menarik,  hirarki  dari 

tingkatan-tingkatan  bahasa  pemrograman. 

Ilustrasi  disampaing  saya  ambil  dari 
http://www.webopedia.com/TERM/l-l/high  level 
language.html 


Menempati  puncak  piramida  atau  yang  biasa 
disebut  dengan  bahasa  tingkat  tinggi  (maksudnya 
bahasa  yang  paling  dekat  dengan  bahasa 
manusia).  Makin  ke  bawah  posisinya  di  dalam 
piramida  ini,  maka  bahasa  tersebut  makin  sulit 
dimengerti  oleh  manusia.  Makanya  di  satu 
tingkat  sebelum  dasar  piramida  biasa  disebut 
dengan  bahasa  mesin  (paling  dasar  sendiri  adalah 
hardware,    dalam    hal    ini    misalnya  adalah 


OK,  kembali  ke  tangga  tertinggi,  yaitu  bahasa  tingkat  tinggi,  ilustrasi  tersebut  mencontohkan 
beberapa  diantaranya:  Fortran,  C,  Pascal ...  ihik-ihik  BASIC  nggak  disebut  karena  terlalu  gampang  dan 
biasa  disebut  bahasa  anak-anak.  Kasihan  dech  ...  hehehe.  Dalam  topik  belajar  bareng  ini,  bahasa 
tingkat  tinggi  akan  diwakili  oleh  file  dengan  ekstensi  *.bas  (bas  singkatan  dari  BASIC). 

Pada  saat  BASCOM  melakukan  Compile,  maka  akan  diproduksi  beberapa  file  langsung  yang  mewakili 
masing-masing  tingkatan  bahasa  di  atas.  File  dengan  ekstensi  *.asm  (asm  singkatan  dari  Assembler) 
adalah  mewakili  tingkatan  Assembly  Language.  Dan  satu  lagi  file  dengan  ekstensi  *.hex  (hex 
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singkatan  hexadecimal  sebab  isinya  file  ini  hanyalah  kode-kode  hexadecimal  dan  hanya  dikenali  oleh 
mesin  atau  mikrokontroler  saja)  yang  mewakili  tingkatan  Machine  Language.  Beberapa  file  lainnya 
yang  diproduksi  oleh  BASCOM  adalah  file-file  selama  proses  linking  dan  sebagainya,  namun  kita 
paling  banyak  akan  berkepentingan  hanya  pada  dua  macam  file  saja  *.bas  dan  *.hex. 

Dengan  satu  kalimat  perjalanan  firmware  tersebut  adalah  *.bas  ->  *.asm  ->  *.hex,  proses  ini  yang 
disebut  compiling. 


Nah  cara  melakukan  compiling  di  BASCOM  ditunjukkan  dengan  prosedur  berikut: 


llustrasi  Grafis 


llustrasi  Deskriptif 


Name 


ICl  20 10-08- 15  -  AVR  -  Simple  LCD  Voltmeter 
|^jLCD_VM_AT  1 6 .  bas 


Size  |  Type  ■* 


5  KB 


File  Folder 
BAS  File 


Gambar  disamping 
memperlihatkan  isi  folder 
project  LCD  Voltmeter,  tampak 
sepelum  dilakukan  compiling 
hanya  ada  1  file  *.bas  saja 


Program     Tools     Options  Wine 


kConnpile 

F7 

Syntax  check 

Ctrl+F7 

si 

Show  result 

Ctrl+W 

m 

Simulate 

F2 

Send  to  chip 

F4 

0 

® 

Reset  Chip 

Shift+F4 

BASCOM-AVR  VI. 11.9.5 


Compiling  LCD_VM_AT1 6. bas 


FlasgSused  :  11% 


1.  Untuk  mengcompile,  lakukan 
save  dulu  file  *.bas,  lalu  pada 
top  bar  menu  Program  » 
Compile.  Bisa  juga  dilakukan 
dengan  menekan  tombol  F7, 
atau  bisa  juga  dengan  click  icon 

bergambar  IC. 

2.  Tunggu  sebentar,  maka  akan 
muncul  dialog  BOX  status 
compiling,  Flash  Used:  11% 
memperlihatkan  jumlah 
memory  yang  dipakai.  Karena 
project  ini  memakai  ATMEGA- 
16  dengan  Flash  Memory  16kB, 
maka  ll%*16kB  =  1.76kB 

3.  Bila  tidak  ada  pesan  error,  maka 
firmware  tersebut  telah  selesai 
dicompile 


Name 


£2)2010-08- i5  -  AVR  -  Simple  LCD  Voltmeter 
|ijjLCD_VMJT16.bas  ' 

||lcd_vm_ati6.bm 

£  LCD_VM_AT16.bin 
@LCD_VM_AT16.dbg 
l*]LCD_VM_AT16.hex 
||]LCD_VM_AT16.obj 
^LCD_VM_AT16.rpt 


Size  |  Type 


File  Folder 

5  KB  BAS  File 

1  KB  BM  File 

2  KB  VLC  media  file  (.bin) 
13  KB  DBG  File 

6  KB  HEX  File 
9  KB  OBJ  File 

111KB  RPT  File 


Gambar  disamping 
memperlihatkan  pertambahan 
jumlah  file  setelah  dilakukan 
compiling. 

File  yang  terpenting  untuk 
proses  berikutnya  adalah  *.bas 
dan  *.hex 

File  dengan  nama 
LCD_VM_AT16.hex  yang  akan 
kita  burning  ke  mikrokontroler 
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KESIMPULAN 


Tulisan  sederhana  ini  berusaha  memberikan  petunjuk  sederhana  dalam  mengoperasikan  aplikasi 
BASCOM. 

BASCOM  juga  menyediakan  HELP  file  yang  akan  memberikan  panduan  kepada  kita  dalam  upaya 
lebih  mendalami  aplikasi  ini. 

Semoga  materi  sederhana  ini  berguna  ...  de  ydlchs 
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